home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / initor17.zip / INITOR.HLP < prev    next >
Text File  |  1996-10-16  |  12KB  |  280 lines
  1. CHANGING INI FILES:
  2. ~~~~~~~~~~~~~~~~~~~
  3. If you want to change to another INI file click on "File" (ALT-f).
  4.  
  5. You can choose:
  6.   - USER INI FILE (os2.ini)
  7.   - SYSTEM INI FILE (os2sys.ini)
  8.   - USER AND SYSTEM FILE (above together)
  9.   - Other INI files (this could be for example AmiPro's INI FILES)
  10.  
  11. If you click on USER or SYSTEM file the user and/or system INI file are opemed
  12. as set in the enviromental variable which must be set in the config.sys file.
  13. If you choose "Other .." a file dialog box is opened with the directory shown
  14. where INITOR was started up. You can open another (personal) INI file.
  15.  
  16. If file is not an INI file, an error message will be displayed.
  17.  
  18. If you save the path as shown below "Saving ..." the next time you 
  19. open INITOR the file dialog box opens with the last saved path.
  20.  
  21.  
  22. MOVING AROUND:
  23. ~~~~~~~~~~~~~~
  24. You simply click on an application to go to another application in the
  25. "Application Name" Window using scroll bars as well.
  26.  
  27. You can use the TAB key to switch between the applicatio or key windows
  28. and scroll using the cursor keys.
  29.  
  30. All key names of that application will be displayed in the "Key Name" window.
  31.  
  32. The data of the first key will be displayed in HEX and ASCII.
  33. If you need another key, click on another key and the new data will be 
  34. displayed with offset and the number of bytes in HEX and ASCII.
  35.  
  36.  
  37. EDIT KEYS AND KEY DATA:
  38. ~~~~~~~~~~~~~~~~~~~~~~~
  39. To change the data of an  application use "Edit Application" (alt-e).
  40.  
  41. A Dialog box will appear with the application name in the first row,
  42. the key name in the second row and the key data last.
  43.  
  44. You cannot change the application name, that is set read only but you can
  45. change the key name and the data.
  46.  
  47. The first dialog box is for ASCII strings with values above 32 and below
  48. 127 (ASCII). If key data is shown with values below 32 you can click
  49. on "HEX" button and another dialog box appears to be able to change
  50. binary data.
  51.  
  52. If you want to edit keys larger than 10500 bytes you might consider reading
  53. the SPLIT/UNSPLIT option below.
  54.  
  55.  
  56. HEX DATA EDITING:
  57. ~~~~~~~~~~~~~~~~~
  58. If you clicked on the HEX button in the "ADD-EDIT" dialog box above a
  59. dialog box appears to edit hex (binary) data. 
  60.  
  61. Just edit data as required keeping a space between each BYTE and use 
  62. HEX and BINARY numbers to enter data into the window.
  63.  
  64. You must keep a space between each byte or else your data will not
  65. be accepted. The box will stay until the data is accepted 
  66. or you press CANCEL.
  67.  
  68. You must end the data in the hex window with a "00" and a space. 
  69. The "00" is part of the key data in the INI files and the space
  70. is the programs way to determine a byte separated from another byte.
  71.  
  72. I dont think this is a major problem although it might seem a little
  73. awkward in the first place.
  74.  
  75. If you want to edit keys larger than 10500 bytes you might consider reading
  76. the SPLIT/UNSPLIT option below.
  77.  
  78.  
  79. DELETING APPLICATIONS AND KEYS:
  80. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  81. If you need to delete a key or application click on "Delete Items" (ALT-d).
  82.  
  83. "Delete Application" will delete the applcation pointed at with all keys 
  84. belonging to THAT application and the data belonging to the keys.
  85. An application example:  "AMIUSER" in the provided test.ini!
  86.  
  87. "Delete Selected Key" will only destroy the key and the data.
  88. A key example of above application:  "BackUpPath"
  89. Data for the above key:              "d:\tmp"
  90.  
  91. You are asked for confirmation to delete the key/application.
  92. The key name is displayed on the query mennu, so you know which key it is.
  93.  
  94.  
  95. ADDING APPLICATIONS AND KEYS:
  96. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  97. If you need to add a new application or add a key to an existing 
  98. application choose "Add Items" (ALT-A).
  99.  
  100. "Add new application" adds a new application to the INI file. An 
  101. application is for example "AmiPro". If you add a new application 
  102. it will be sorted alphabetically (not in the INI file).
  103.  
  104. "Add new key" adds a new KEY to the current application pointed at.
  105. A new key would be for example "INIPATH" (data in my case: d:\os2).
  106.  
  107.  
  108. SAVING (COPYING) DATA AND SCREEN LOCATION:
  109. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  110. The data is saved automatically when you press OK in the ADD or EDIT
  111. (HEX EDIT) dialog boxes.
  112.  
  113. If you want to save (or copy) an application or key to another file
  114. you may do so by using the save menu (ALT-s): 
  115.  
  116. There are three options available:
  117.     Save Application to other (INI) File
  118.     Save Key to other (INI) File
  119.     Save ALL to other (INI) File
  120.  
  121. After you clicked on one of the three you are asked (dialog box) to specify
  122. the file name. If you specify an existing file the information is simply added
  123. to the file. If the file is NOT a proper INI file an error message will
  124. be displayed and nothing will happen.
  125. If the file opened and if applications or keys with the same name exist
  126. in the OPENED file exist, they are simply overwritten. So you must make sure
  127. you do not overwrite the current application in the "save to" file.
  128. (You could simply open another copy of the INITOR.)
  129.  
  130. The first option saves ALL KEYS of one APPLICATION to a new file.
  131. The second option saves ONE KEY of one APPLICATION to a new file.
  132. The third option saves all information in the current file to a new file.
  133.  
  134. You can save the window location (quite handy) by selecting "Screen Location".
  135.  
  136. You can save the last paths:
  137.     SAVEREAD PATH saves the path of the directory last read from/save to.
  138.     DISPLAY PATH saves the path of the last INI file displayed.
  139.  
  140. These information is stores in a file called INITOR.INI in the programs
  141. directory. You can edit it and have a look at it.
  142.  
  143.  
  144. READING IN OF DATA OF OTHER INI FILES:
  145. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  146. If you want to read data from a specified INI file into the current displayed
  147. file simply click on (ALT-r):
  148.  
  149. There are two choices to read from another file into the current file:
  150.      Read Application form other file.
  151.      Read other INI file into current file.
  152.  
  153. Once you clicked on one of the items, you are asked to specify a filename
  154. to read from. If you specify a new file it is opened (for saving only).
  155. If you specify an existing file it is checked and if it's not a proper INI 
  156. file an error message will be displayed and nothing happens.
  157.  
  158. Read other INI file into current file.
  159. Load the INI file you want to add the data and click on the READ menu 
  160. to read in the data from a specified file. Note that the complete file is read
  161. into the current file and if a KEY/APPLICATION of a name in the current file
  162. exists, it is simply overwritten. No check is made.
  163.  
  164. Read Application form other file:
  165. Load the INI file you want to add the data and click on the READ menu 
  166. to read in the data from a specified file. You are asked afterwards in a 
  167. select dialog box which applications you want to read into the current file.
  168. Simply select each of the items you want an click on OK.
  169. If a KEY/APPLICATION of a name in the current file exists, it is 
  170. simply overwritten. No check is made.
  171.  
  172.  
  173. POPUP MENUS:
  174. ~~~~~~~~~~~~
  175. There are two POPUP menus availabe depending the window the cursor is on.
  176. These POPUP menus are selected when the right mouse button is pressed
  177. in either of the windows.
  178.  
  179. If the cursor is in the application window, the following popup is displayed:
  180.   ADD  Application
  181.   Save Application
  182.   Delete Application
  183.   Edit Application ASCII
  184.   Edit Application HEX
  185.   Refresh
  186.  
  187. If the cursor is in the key window, the following popup is displayed:
  188.   ADD Key
  189.   Save Key
  190.   Delete Key
  191.   Refresh
  192.  
  193. If you do not select anyone of the items, nothing will happen.
  194. You must hold the right mouse as long as you want to select something.
  195. The popup menu disappears as soon as the mouse button is released.
  196.  
  197.  
  198. ACCELERATOR KEYS:
  199. ~~~~~~~~~~~~~~~~~
  200. A number of accelerator keys are available to jump to certain options:
  201.  
  202. SHIFT       A:       Displays the about box.
  203. SHIFT       U:       Loads the USER PROFILE into the editor.
  204. SHIFT       S:       Loads the SYSTEM PROFILE into the editor.
  205. SHIFT       O:       Opens up a diaplog box to load in user specified INI file.
  206. SHIFT       R:       Refreshes data displyed in editor window.
  207. ALT         X:       Exit INITOR.
  208.            F1:       Help window is displayed.
  209. SHIFT   SPACE:       Edit selected application in HEX window.
  210.         SPACE:       Edit selected application in ASCII window.
  211. SHIFT  INSERT:       Add key to selected application.
  212.        INSERT:       Add application to current INI file.
  213. SHIFT  DELETE:       Delete current key selected (Question box appears).
  214.        DELETE:       Delete current application selected.
  215.                      (Question box appears).
  216.           TAB:       Switch between application and key window.
  217.  
  218. The keys are displayed on the menus as well.
  219.  
  220.  
  221. SPLIT AND UNSPLIT KEYS:
  222. ~~~~~~~~~~~~~~~~~~~~~~~
  223. There is a limitation of how many bytes one can display in a dialog box.
  224. This is set to 32K. However, the HEX editor needs fo each byte used 3 bytes
  225. to display the entity. 32K / 3 > 10500bytes.
  226.  
  227. Therefore if you need to edit a key which is larger than 10500 bytes you
  228. need to split the key first. Using the SPLIT item from the MISC MENU will
  229. split the key into 8000 byte chunks, with the last being the remainder
  230. of the key, hence a 19396 byte long key is split into 2x8000 and 1x3396.
  231. You need to place the cursor on the key to be split.
  232.  
  233. Using the UNPLIT option will put the keys together again. If you have edited
  234. one of the split keys this will produce a larger key or smaller key than
  235. the original one, depending on what you have done with the split keys.
  236.  
  237. Consider the unsplit key is called "testing" and its 19396 long.
  238. than the split keys are called and sized:
  239.  
  240.      testing_Initor SplitKey_1, 8000
  241.      testing_Initor SplitKey_2, 8000
  242.      testing_Initor SplitKey_3, 3396
  243.  
  244. Please leave the names until you unsplit them otherwise the program has no
  245. way to find out which key is split and which of the keys belong together.
  246. When unsplitting the cursor must be placed on the first key to unsplit.
  247.  
  248.  
  249. HELP:
  250. ~~~~~
  251. Help is diplayed by using Help on the menu.
  252.  
  253.  
  254. NOTE:
  255. ~~~~~
  256. Note that this editor was written with speed in mind. I am looking 
  257. after a few systems (LanServer 4.0 etc) and needed a quick INI editor 
  258. to change a few settings to make a few applications "behave" a little better. 
  259. I got frustrated with LOTUS INI editor because it doesn't remember the last 
  260. path, screen location and comes up with this box at startup telling you its 
  261. dangerous to change something in you INI files (dont we all know?????).
  262. So I wrote this one and use it (and a few friends too) nearly every day.
  263. An I left out a few things to make this program faster to work with
  264. and not have to press too many buttons.
  265.  
  266.  
  267. TEST INI FILE:
  268. ~~~~~~~~~~~~~~
  269. I have included a test INI file which you can load an try out a few things 
  270. before you want to change the "real" ones. It has a number of applications,
  271. keys and key data in it. The file is taken from my LOTUS AmiPro.
  272. It is the "AMIUSER3.INI" files which contains all the setttings of a user.
  273. The first APPLICATION is the "AMIUSER" in that file.
  274. A KEY is for example the "BACKUPPATH" and the KEYDATA is "H:\AMIPRO\TMP"
  275. (AmiPro's direcotry on my machine is on "H").
  276. Try a few things here and you get the idea.
  277.  
  278. You could test run INITOR'S INI file. Dont worry if you changed something 
  279. incorrectly. Simply resave in that case.
  280.